home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 November / macformat-043.iso / mac / Shareware Plus / Developers / OpenStack Rinaldi Collection / openstack-rinaldi-lib / ClipToPict 1.5 (US) / ClipToPict 1.5 (US).rsrc / HELP_5635 next >
Encoding:
Text File  |  1996-01-09  |  4.2 KB  |  90 lines
  1.  
  2.  
  3.                                            ClipToPict 1.5
  4.  
  5.                                         by Frédéric RINALDI
  6.  
  7. DESCRIPTION
  8.    Transfers a picture from the clipboard to a PICT file or PICT resource, by modifying it if required.
  9.    See also PictToClip XCMD to transfer a Pict to the ClipBoard.
  10.  
  11. SYNTAX
  12.        ClipToPICT <pathname>[,<file|res[ource]>][,<res name>][,<res ID>]
  13.                         [,<keep prop.>][,<New size>][,<TheClipRect>]
  14.                         [<d=1|2|4|8|16|32>][<c=L[ow]|N[ormal]|H[igh]>]
  15.  
  16. PARAMETERS
  17.    <pathname> can be a single name or whole pathname. If just a single name is supplied, the file is assumed to be in the same folder than the current stack. Aliases are also supported. If empty or omited, the default created file is named "PICTFile X" at the current stack's level, X being a positive integer which increments automatically.
  18.  
  19.    <file|res[ource]> tells if destination file is a PICT file ("file"), or a file containing a PICT resource ("res"). Default is "file".
  20.  
  21.    <res name> is needed only for resource, and is the name the PICT resource to create.
  22.  
  23.    <res ID> is needed only for resource, and is the ID the PICT resource to create.
  24.  
  25.    <keep prop.> is boolean, and tells the picture to keep its proportions when resized (TRUE) or to be scaled to fit in the destination rect (FALSE). Default value is FALSE.
  26.  
  27.    <New size> is a point "X,Y" giving the new size of the picture (X=width, Y=height).  This value is always clipped to the maximum size according to original image resolution (ex : a 100*100 at 300dpi image can be max. resized to 400*400 at 72dpi).
  28.  
  29.    <ClipRect> allows to keep only a rectangular area of the picture. It will be
  30. "Xt,Yt,Xb,Yb" shaped, and inactive by default.
  31.  
  32.    <d=1|2|4|8|16|32> allows to modify the pixel depth of the saved picture.This parameter is used only if QuickDraw32 is active.
  33.  
  34.    <c=L[ow]|N[ormal]|H[igh]> allows to compress the captured picture if QuickTime is installed and QuickDraw32 is running. "Low" gives the best quality.
  35.  
  36.    Using "!", "?" or "=" as first parameter will return an online help (resp. copyright, syntax and output).
  37.  
  38. USING
  39.    Any existing resource will be replaced by the new one.
  40.  
  41. ERRORS
  42.    If an error occurs, the Result can contain :
  43.      "Error : Out of memory"
  44.      "Error : No PICT in Clipboard"
  45.      "Error : Incorrect depth"
  46.      "Error : Incorrect compression quality"
  47.      "Error : Bad size parameter"
  48.      "Error : Missing resource ID or name"
  49.      "Error : Clipping rect doesn't intersect pict rect"
  50.      "Error : Couln't add resource"
  51.      "Error : Not a file"
  52.      "Error : Alias file not supported"
  53.      "Error : Original item not found"
  54.      "Error : Volume not found"
  55.      "Error : Bad Name"
  56.      "Error : File not found"
  57.      "Error : Folder not found"
  58.      "Error : File is busy"
  59.      "Error : I/O Error"
  60.      "Error : Folder is full"
  61.      "Error : Volume is locked"
  62.      "Error : Duplicate file/folder name"
  63.      "Error : AppleShare insufficient privileges"
  64.  
  65. HISTORY
  66. 1.5                                                                                         10/28/93
  67. • Fixed bug on non-QuickDraw32 CPUs
  68.  
  69. 1.4                                                                                         10/17/92
  70. • Added picture modification features
  71.  
  72. 1.2                                                                                         01/06/92
  73. • No change
  74.  
  75. 1.1                                                                                         12/25/91
  76. • Fixed alias file bug under System 7.0.1
  77.  
  78. 1.0                                                                                         11/01/91
  79. • First release
  80.  
  81. This stack also uses ClipInfo XFCN, © Frédéric RINALDI 1989…1993
  82. --------------------------------------------------------------------
  83.    All externals included in this stack are FreeWare and may be used in non-commercial software provided the following notice is visibly present :
  84.  
  85.                 ClipToPICT XCMD, © Frederic Rinaldi, 1989…1993.
  86.  
  87.    Free for non-commercial use. Use in commercial software subjected to prior acknowledgement and licensing from the author, reachable at the following network addresses:
  88.  
  89. AppleLink: RINALDI1   CalvaCom : FR10    Compuserve : 71170,2111
  90.                Internet : RINALDI1@APPLELINK.APPLE.COM